home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 1.iso / ARGONET / PD / COMMS / ATTACHER.ZIP / !Attacher / !Help < prev    next >
Text File  |  1998-03-16  |  9KB  |  218 lines
  1. Attacher 1.03
  2. =============
  3.  
  4.  
  5. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  6. + © John Allen 1997, 1998.  This application is Freeware and is     +
  7. + supplied on the understanding that:                               + 
  8. +                                                                   + 
  9. + 1. The source code is not altered in any way                      +
  10. + 2. Any copies made contain all of the files in the directory      +
  11. + 3. It is not sold for a profit                                    +
  12. + 4. It is not included on any disc costing more than £2 or         +
  13. +    CD rom costing more than £15 without my prior written          +
  14. +    permission                                                     +
  15. +                                                                   +
  16. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  17.  
  18.  
  19. Attacher codes and decodes uucode and base64 files such as might be 
  20. sent and received as attachments via Usenet newsgroups or e-mail 
  21. on the Internet.  It works totally on the RISC OS desktop and is 
  22. designed to work under RISC OS 3.00 and later versions.
  23.  
  24. As well as decoding single files it will also turn a series of messages 
  25. containing sections of a uu encoded file (such as might be found in 
  26. newsgroups with'binaries' in the title) into a single decoded file.  
  27.  
  28. Likewise it will split long uuencoded files into short sections to send in 
  29. separate messages.
  30.  
  31. It will extract multiple uuencoded or base64 coded files from a single 
  32. message, such as might be created by as attachments by a PC mail
  33. application.
  34.  
  35. Interactive help is fully supported in all windows and menus.
  36.  
  37. The following files should be included in the Attacher directory:
  38.  
  39. !Boot
  40. !Help
  41. !Run
  42. !RunImage
  43. !Sprites
  44. !Sprites22
  45. TypeTrans
  46. TypeTransH
  47. Resources directory containing: Messages, Sprites, Sprites22, Templates
  48.  
  49.  
  50. Use 
  51. ===
  52.  
  53. Double click on the Attacher icon in the Filer window.  This installs 
  54. Attacher on the iconbar and opens the main coding and decoding window.
  55.  
  56. Clicking on the Attacher icon on the iconbar will re-open the main 
  57. window if it has been closed.  If the window is already open it will 
  58. bring it to the top of the window stack.
  59.  
  60. Attacher is designed to be simple to use, making use of file drag and
  61. drop.  To decode: drop a file icon on the decode icon and to code drop 
  62. it on a code icon.  The resulting file can then be dragged where ever 
  63. it is required, or named and saved or double clicked to load it into
  64. an appropriate application.
  65.  
  66.  
  67. Choices window
  68. ==============
  69.  
  70. This allows Attacher to be cusomised to individual users' requirements.
  71. Setting can either be saved, by clicking 'Save', to be used by Attacher
  72. each time it is loaded until different options are selected or, by
  73. clicking 'Use' they can be used for the session, the previous settings
  74. being used when Attacher is next loaded.  The window is selected from the
  75. Attacher main window.
  76.  
  77. The options that can be set are:
  78.   
  79. * Filename of coded file (different options for uucode and base64)
  80. * Whether attacher should try to identify a PC file extension for
  81.     coded files
  82. * Whether uucoded files should be split into segments (if so the size
  83.     of segments and their names can be set)
  84. * Whether PC file extensions should be stripped from the filenames of  
  85.     decoded files
  86.    
  87.  
  88. Decoding files
  89. ==============
  90.  
  91. To decode a file or series of files:
  92.  
  93. 1. Drag a file containing coded data to the decode icon at the 
  94. top left of the main window.  There's no need to edit the header 
  95. off the file, just use the whole file.  If it is uuencoded Attacher 
  96. will detect whether it is a complete uuencoded file or give a prompt 
  97. for the next file in a series.  (If so continue dragging the series 
  98. of coded files to the decode icon until Attacher detects the end of 
  99. uuencoded data).  The files must be dragged in order.
  100.  
  101. 3. Attacher decodes the complete coded file.
  102.  
  103. 3. Edit the supplied name as appropriate, then drag the file icon to a 
  104. Filer directory display or to another application.  Alternatively enter 
  105. the full pathname of the file and click select on the 'OK' icon.  
  106. Additionally you can double-click select over the file icon to load it 
  107. into an appropriate application (if known to RiscOS at the time of 
  108. clicking). 
  109.  
  110. 4. If there are further files in the message they will be presented for 
  111. saving in turn.
  112.  
  113.  
  114. Coding files
  115. ============
  116.  
  117. 1. Drag the file you wish to encode to one of the the code icons at the 
  118. bottom left or middle left of the main window.  In case of doubt it is 
  119. usually better to uuencode rather than use base64. 
  120.  
  121. 2. Attacher will encode the file.
  122.  
  123. 4. Edit the file name supplied by Attacher as appropriate and drag the 
  124. file icon to a Filer directory display or to another application.  
  125. Alternatively enter the full pathname and click select on the 'OK' icon.  
  126. If you have the split option set, and the file is longer than the 
  127. maximum length, Attacher will split the file and keep presenting new
  128. part-files for you to save until the whole file has been saved.
  129.  
  130.  
  131. Features 
  132. ========
  133.  
  134. * Attacher will accept coded files direct from other applications so, 
  135. for example, you can use the 'Save File' option of a news/mail reader 
  136. such as TTFN, Messenger or Marcel and drag the file icon to the Attacher 
  137. decode icon rather than saving the file on disc first.
  138.  
  139. * Attacher will save coded files to other applications so, for example, 
  140. you can insert an encoded file (or section of file) into a message 
  141. being composed by a news/mail reader.
  142.  
  143. * Attacher will also transfer decoded files directly to other 
  144. applications which accept direct transfer.  
  145.  
  146. * Double clicking a coded or decoded file will attempt to load it into 
  147. an application that accepts that filetype.  Note that some applications 
  148. (e.g. Spark) do not take possession of files loaded this way so it is 
  149. vital that the file is processed and saved elsewhere before Attacher is 
  150. closed down - as all Attacher working files (kept in an Attacher sub-
  151. directory in the system Scrap directory) are deleted when it is quitted.
  152.  
  153. * Closing the main window part way through any operation will destroy 
  154. the unsaved data (as per Acorn's guidelines).  To keep the data while 
  155. closing the Attacher main window, hold the shift key down when closing 
  156. it.  This will iconise the window on the pinboard allowing it to be 
  157. reopened by double clicking select on the window icon.
  158.  
  159. * Attacher uses solid sprite dragging if you have it enabled on your 
  160. machine.
  161.  
  162. * Attacher will put the RiscOS filetype at the end of any file it 
  163. uuencodes.  If the "add PC file extension" option is set it will also 
  164. convert the RiscOS filetype to a PC style file extension and append it 
  165. to the filename.  Note this will use any DOSMap settings on your machine
  166. or, if none are set, its own defaults.  In cases where more than one PC 
  167. type is mapped to a RiscOS filetype, the first specified PC type will be
  168. used as the default extension for that type.
  169.  
  170. * When decoding uuencoded files Attacher will check whether there is a 
  171. RiscOS filetype given after the file and will use it to filetype the 
  172. decoded file.  It will also check for the filetype being appended to the 
  173. filename as a comma extension.  
  174.  
  175. * When base64 coding Attacher will append the RiscOS filetype to the 
  176. file name as a comma extension.  At decoding any comma extension will be 
  177. used to set the filetype.
  178.  
  179. * Attacher will translate PC-type file extensions to RiscOS filetypes 
  180. according to the host machine's DOSMap settings using the TypeTrans module.
  181. If no DosMap is set TypeTrans has a default table which is used.  This 
  182. means that output files can easily be double clicked to load them
  183. into other applications.  To add you own translations, or to modify the
  184. ones in use, set your translation by adding DOSMap commands either in
  185. your boot file of Attacher's !Run file (there is an example in the
  186. Attacher !Run file).
  187.  
  188. * Combines and decodes files which have been downloaded on a PC where 
  189. lines end <CR><LF> rather than <LF> in RISC OS.
  190.  
  191. * The "Open Dir" entry on the main menu opens the Attacher work directory
  192. which will contain copies of all files that have been double clicked to
  193. load into other applications.
  194.  
  195.  
  196. The TypeTrans module
  197. ====================
  198.  
  199. This application contains and uses the TypeTrans module by the same author.  
  200. This has an SWI interface to the coders and decoders as well as other 
  201. support fuctions.  Note that although supplied with this application it is 
  202. not Freeware and the user interface is unpublished (except for the calls
  203. documented in the file TypeTransH).
  204.  
  205. Other Freeware authors may request a copy of the user interface specification
  206. and use/distribute the module with their own applications.
  207.  
  208. Authors of commercial software will be expected to pay a royalty if they make
  209. use of calls in this module.
  210.  
  211.  
  212. Any comments, queries, donations or bug reports to:
  213.  
  214. John Allen - e-mail: john@bramber.demon.co.uk 
  215.  
  216. Updates to the software and latest development information can be found 
  217. at:  http://www.bramber.demon.co.uk/john/soft.html
  218.